Programming Notes

SoftwareShield System Feature Guide > Implementation Support > Programming Notes

## Programming Notes

Programming notes are simply HTML documents that are created when you compile your license project that aid you in integrating your license into your application.

These files are named the same as the project, except with an ".html" extension. For example, if your Main License File name is "App1MainLicenseFile.ini" then, when you compile your license project, a programming notes file will be created named "App1MainLicenseFile.html".

Inside the programming notes file is important information that helps you call the StartUp method of the ClientProtector component.

A sample of the contents of a typical programming notes file follows:

SoftwareShield
Programming Notes for: LicenseV3_9.ini

(Compiled at: 07/03/2004 5:23:23 PM)

### General Details:

Host Product Name | Test Host 9
Host Product Description | Test Description 9
Serial Number | test
User Company Name | Co Name
User Name | User
User Address 1 | n/a
User Address 2 | n/a
User Address 3 | n/a
User Phone Number | n/a
User Email Address | n/a

### Virgin Registry Information:

Virgin Registry Information is Not Used
Virgin Key Root | N/A
Virgin Key Path | N/A
Virgin Key Value Name | N/A
Virgin Key Value | N/A

### Alias License Files:

Number Of Alias Files: 5
Alias File # | Alias File Kind | Alias File Name | Alias File GUID | Alias File Location / ROOT KEY
# 0 | Hidden | ms41ms.dll | N/A | Main License File Folder
# 1 | Registry | N/A | {C26AEADF-C2FF-4BBD-A7DF-62AF2EC22399} | HKEY_CURRENT_USER
# 2 | Steganographic | Logo2.bmp | N/A | N/A
# 3 | Hidden | ms255db.tlb | N/A | Main License File Folder
# 4 | Hidden | cc868tiff.bin | N/A | Main License File Folder

### System FingerPrint:

FingerPrint Options Code: 1455235
This FingerPrint Options Code corresponds to setting: Hard Drive Model, Hard Drive Hardware Serial No., Windows Serial Number, Operating System Build Number, Operating System "Windows" Directory, Operating System "Temp" Directory, Machine Platform Type, MAC Address of Network Interface Card 1, User Name.

### Authorization Definitions:

Authorization Definition ID # | Description | Authorization Definition Kind | Parameter Description
--- | --- | --- | ---
0 | release copy pro | RELEASE Copy Protection |
1 | recover license | RECOVER From Failure |
2 | release all expiration | RELEASE All Expiration |
3 | change expire date | CHANGE Hard Expire Date |
4 | add exes | ADD Allowable Executions |
5 | Pay Per Use Tracker | GENERAL Use | parameter holds the number of pre-paid uses remaining in the license

### License Behaviour:

Copy Protection | Disabled
FingerPrint All Activation Codes | Activation Codes Are FingerPrinted
Prompt For Recovery | Will Prompt
Auto Recover | Will Not Auto-Recover
Auto Main License Replace | Will Not Replace Main License
Resist User Debuggers | Resist User Debuggers Not Enabled
Resist SoftICE | Resist SoftICE Not Enabled
Resist Tracers | Resist Tracers Not Enabled

### Expiration:

LicenseV3_9.ini DOES Expire.
Expire Hard Date | 21/06/2002
Expire Period | 5 Days.
Execution Limit | 5 Executions.
Date Time Last Used Setting | 04/11/2002 1:47:00 PM

### User Defined Fields:

User Defined Field | Value
--- | ---
String #0 | (empty)
String #1 | (empty)
String #2 | (empty)
String #3 | (empty)
String #4 | (empty)
String #5 | (empty)
String #6 | (empty)
String #7 | (empty)
String #8 | (empty)
String #9 | (empty)
Date #0 | 30/12/1899
Date #1 | 30/12/1899
Date #2 | 30/12/1899
Date #3 | 30/12/1899
Date #4 | 30/12/1899
Number #0 | 0
Number #1 | 0
Number #2 | 0
Number #3 | 0
Number #4 | 0

Critical StartUp Details:

In your FormLoad event or startup of application, call the StartUp function of the ClientProtector COM object with the following parameters:

License File Name: LicenseV3_9.ini
Main License File Password: password
Global Authorization Definition Password: globalpassword

Finger-Print Options Code: 1455235
(For reference only this Finger Print Option Code corresponds to setting: Hard Drive Model, Hard Drive Hardware Serial No., Windows Serial Number, Operating System Build Number, Operating System "Windows" Directory, Operating System "Temp" Directory, Machine Platform Type, MAC Address of Network Interface Card 1, User Name. )

### C++ StartUp Example

// Note this example assumes you have deployed the Main License File to the host application directory.

char * MainLicenseFileName = {"LicenseV3_9.ini"};
char * MainLicenseFilePassword = {"password"};
char * GlobalAuthorizationCodePassword = {"globalpassword"};
int FingerPrintOptionsCode = 1455235;
long return_code;

CoClientProtector->StartUp(MainLicenseFileName, MainLicenseFilePassword, GlobalAuthorizationCodePassword, FingerPrintOptionsCode, &return_code );

### VB StartUp Example

// Note this example assumes you have deployed the Main License File to the host application directory.

Dim return_code As Long
Call pCoClientProtector.StartUp("LicenseV3_9.ini", "password", "globalpassword", 1455235, return_code)